****************************************
*     README FILE FOR MUNCH V1.0       *
*                                      *
*   BY George Styles aka FusIoNMaN     *
*                                      *
*    www:  www.ganga.demon.co.uk       *
*   mail:  fusion@ganga.demon.co.uk    *
****************************************

1. What is it?

It is a hex editor and R3000 disassembler. 
It is aimed in particular at Playstation
.EXE files, but can load files as raw
data as well.

2. What does it do?

It does:

 * Loads files as raw data, or treats
   them as a Playstation .EXE file

 * Disassembles all r3000 instructions
   (I think ;))

 * Hyperlinked jumps, just click on a
   jump to go to the target address

 * Symbol table for fields in .EXE 
   header

 * Saves assembly to a text file

3. How to use it

First use the standard file dialog box to
find a file to disassemble

If the file is a raw object file (ie. .obj,
.cpe .o etc) then click on 'Load File Raw'
to load the file without any header info.

If the file is a playstation .exe file,
click on 'Load PSX .EXE'. This will load
the file, and use the header fields in the
.exe file to set up the correct addresses
and start address in the symbol table.

Click on either disassemble, or hex edit
to view the file in either format.

When in the disassembler, you can click on
a jump instruction to follow the jump.

Use the normal cursor/page keys to navigate
around the hexedit or disassembly

When in disassembly mode, you can adjust the
address offset (0-3) using the left and right
cursor keys, so the instructions are correctly
aligned.

4. Future additions

 * Tidy up of front end
 * Live connection to Playstation
   using Pro Action Replay so
   you can disassemble the psx
   ram while playing game
 * Add your own symbols to 
   symbol table
 * Ability to save changes in
   hex edit (easy to do...)
 * Assembler so instructions can
   be changed
 * System calls by name, not 
   number
 * Co-processor functions...
 * Anything anyone suggests to
   me

5. Contacting me

You can find my web page at

 http://www.ganga.demon.co.uk

or you can mail me on

 fusion@ganga.demon.co.uk

or if you can send SMS messages
to the UK Mercuary 121 network,
either from a 121 phone, or 
from a net gateway, you can
sms me on 

 +44956390348

